home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / biz / demo / afaxdemo1_34.lzh / AfaxDemo / docs / getty_doc < prev    next >
Text File  |  1992-08-26  |  9KB  |  270 lines
  1. Additional Features added to AmigaUUCP1.16 Getty for AmigaFax
  2. ==============================================================
  3.  
  4. Additional command line parameter added.
  5.  
  6. -Fn          n=bit-mapped register
  7.                              
  8.  bit                                                          
  9.   0  =  1   (always set for Fax)                              
  10.  
  11.   1  =  0   Set rate to 19200 after +FCO                      
  12.      =  1   Don't set rate to 19200 after +FCO, DCE/DTE locked
  13.  
  14.   2  =  0   Dont Open/Close serial on modem-init              
  15.      =  1   Open/Close serial on modem-init
  16.  
  17. So for example, if you want to operate in Fax-Compatible mode, with
  18. your modem having a locked DCE/DTE rate, and you want to Close/Open
  19. the serial device between calls (for some reason this helps a lot when
  20. using the ZyXEL modem, and the A2232 multi-port serial card), you
  21. would add the parameter -F6 when starting Getty.
  22.  
  23. ==========================================================================
  24.  This is the Getty documentation from the AmigaUUCP1.16 distribution
  25. ==========================================================================
  26.  
  27. NAME
  28.     Getty
  29.  
  30. SYNOPSIS
  31.     Getty -Sserialname -Uunit -Bbaud -Bbaud.. -Mc -bn -ln
  32.           -m1 -r0 -h0 -c0 -d0 -xn -A -7 -0 [modem-cmds]
  33.  
  34. FLASH!
  35.     Getty now works with multi-serial ports.  The 1.08 and 1.09
  36.     getty were broken due to bugs in the serial.device ... the 1.10
  37.     Getty now fixes this by introducing file locking constructs to
  38.     lock the serial port instead of intercepting the device vectors.
  39.  
  40.     IN ORDER TO BEHAVE WELL WITH GETTY, YOU MUST USE THE LockSerial
  41.     command to run any external programs that use that particular
  42.     serial port.  You can no longer run terminal programs direct
  43.     because they are no longer locked out by getty if getty is
  44.     accepting a call.  The program LOCKSERIAL may be used to
  45.     synchronously run terminal programs without requiring one to
  46.     kill Getty.
  47.  
  48.     HOWEVER, programs run *FROM* a password entry should NOT use
  49.     LockSerial becaues the port has already been locked by getty
  50.     for the program.
  51.  
  52.     NOTE: Programs run with lockserial must not auto-detach from the
  53.     CLI or lockserial will believe that they have exited and give the
  54.     port back to Getty, causing major problems.
  55.  
  56. DESCRIPTION
  57.     Getty hangs on the specified serial port (serial.device unit 0 by
  58.     default) waiting for connections via the connected modem.  Once
  59.     a connection is accepted Getty adjusts to the proper baud rate
  60.     using the CONNECT message, -B, -A options, then provides a
  61.     Login: request to the caller.
  62.  
  63.     NOTE: A CONNECT message from the modem with no baud rate specified
  64.     will cause Getty to use the first baud rate in the -B list.  If
  65.     the -A option is specified, Getty *always* uses the first baud
  66.     rate in the -B list and never switches to any other baud rate.
  67.  
  68.     Getty disconnects any caller who cannot provide a legal Login and
  69.     Password within 60 seconds.  It also allows only 5 login attempts
  70.     before disconnecting, and any illegal password will result in a
  71.     4 second delay before the next Login: prompt is output.
  72.  
  73.     Upon receiving a legal Login and and Password, verified via
  74.     GETTY:PASSWD, Getty will execute the program specified in
  75.     GETTY:PASSWD, usually UUCICO, and stay off the line until
  76.     UUCICO returns.  When UUCICO returns, Getty will disconnect
  77.     the caller and reset the modem, returning to its original state.
  78.  
  79.     The file GETTY:Getty-Header contains a couple lines of text
  80.     that are sent over the serial port before the Login: request.
  81.     In it you normally have your machine type, name, etc...
  82.  
  83.     Getty runs the specified program in the password entry adding
  84.     the following arguments:
  85.  
  86.         -Getty -DEVICE devicename -UNIT unitnumber
  87.  
  88.     (uucico will recognize said arguments and not attempt to
  89.      initialize / waitfor calls / hangup the modem itself, nor
  90.      will uucico attempt to lock the already locked serial port)
  91.  
  92. TECH NOTES
  93.     In order to monitor the request lock for the serial port (see
  94.     UUMAN:LockSerial and src/util/lockserial.c), GETTY must open
  95.     a file in T: for write and then close it every 3 seconds.  Thus,
  96.     T: should be in your RAM disk.
  97.  
  98. OPTIONS
  99.     Options are given on the command line when you run Getty.  You can
  100.     also UPDATE a currently running Getty's options by running Getty
  101.     for the same device and unit again with the options that need to
  102.     be changed.  Getty will detect whether another getty is already
  103.     running on that port and send the new options to the running getty,
  104.     then return.
  105.  
  106.  
  107.     -Sserialname        Specify serial device, default "serial.device"
  108.  
  109.     -Uunit            Specify unit number, default 0
  110.  
  111.     -Bbaud            Specify up to 32 baud rates
  112.  
  113.     -A            Specify modem will adjust to a single baud
  114.                 rate (locks the serial.device at the first
  115.                 baud rate in the -B list)
  116.  
  117.     -7            Use SERF_7WIRE protocol while online,
  118.                 else uses no protocol while online.  If
  119.                 you are using a modem with speed conversion
  120.                 you need this option or you will most likely
  121.                 overflow the modem's buffer!
  122.  
  123.     -Mc            Select Modem type,
  124.  
  125.                 c = m   Multimodem
  126.                 h   Hays
  127.                 d   Dumb  (no AT or +++ commands are
  128.                        sent to the modem ever).
  129.  
  130.     -mn            Set modem speaker level, default 0.
  131.                 (ATMn command)
  132.  
  133.     -rn            Set modem to answer on the Nth ring
  134.                 (modem must support ATMn).  0 disables
  135.                 answer capability.    The default is to
  136.                 answer on the second ring.
  137.  
  138.     -h0            Ignore CD (carrier detect).  If this option
  139.                 is specified a continuous carrier detect is
  140.                 assumed, causing Getty to request Login:'s
  141.                 over the line as soon as it receives a CONNECT
  142.                 message.
  143.  
  144.                 It is suggested you ONLY use this option
  145.                 when combined with -c0
  146.  
  147.     -c0            Do NOT look for a CONNECT message from the
  148.                 modem... useful for dumb modems.
  149.  
  150.     -d0            Normally Getty will disconnect by dropping
  151.                 DTR.  If this option is specified, Getty will
  152.                 use the less reliable +++ ATH0 sequence.
  153.  
  154.                 NOTE: If your modem has the capability to LOCK
  155.                 the COMPUTER'S SERIAL PORT baud rate, it is
  156.                 *strongly* suggested that you do this for +++
  157.                 to be reliable.
  158.  
  159.     -xn            Set debugging level to n.  If specified
  160.                 debugging messages are sent to stdout instead
  161.                 of GETTY:LOGFILE
  162.  
  163.                 Note: to avoid GETTY:LOGFILE getting too
  164.                 large for busy systems, you can always add
  165.                 an entry to your crontab to delete it once
  166.                 a week (or whenever), or use 'trimfile' to
  167.                 trim it.
  168.  
  169.     -l1            add -HLINK option to commands started by
  170.                 Getty.
  171.  
  172.     -b1            add -BAUD <baud> option to commands started by
  173.                 Getty, this informs the run command what the
  174.                 actual connect baud rate is regardless of the
  175.                 serial port communications baud rate (which is
  176.                 already preset by getty for the application)
  177.  
  178.     -0            Kill any already-running Getty for this
  179.                 serial port and unit.
  180.  
  181.     modem-cmds        You may specify up to 16 specific commands
  182.                 to be sent to the modem whenever it is
  183.                 initialized (usually after a disconnect
  184.                 and on startup).  Each command will be
  185.                 sent to the modem with a CR on the end and
  186.                 a seconds delay afterwords.  Example:
  187.  
  188.                 ATS2=.
  189.  
  190.                 This is useful for provided specialized
  191.                 modems with the appropriate initialization
  192.                 strings.
  193.  
  194. EXAMPLE
  195.     ;   Run a Getty for a MultiModem
  196.  
  197.     run >nil: <nil: Getty -Mm -A -B19200
  198.  
  199.     ;   Run a Getty for a Hays Modem
  200.  
  201.     run >nil: <nil: Getty -Mh -B1200 -B2400
  202.  
  203.     ;   Run a Getty for a Hays Modem and use +++ instead of DTR to
  204.     ;   hangup.  NOTE, when using -d0 you should lock the serial port
  205.     ;   baud rate (if possible) or +++ may be unreliable as a hangup
  206.     ;   method.
  207.  
  208.     run >nil: <nil: Getty -Mh -B2400 -d0
  209.  
  210.     ;   Modify options to a Getty already running in the background
  211.  
  212.     Getty -m1        ; Set speaker on during dialing
  213.     Getty -m0        ; speaker off at all times.
  214.     Getty -0        ; kill background Getty
  215.  
  216. EXAMPLE CRONTAB ENTRIES
  217.     Assuming a getty has been run in the background from your
  218.     startup sequence, the most common desire is to disable the
  219.     modem speaker while you are asleep, and enable it at other
  220.     times.    The following crontab entry will accomplish this:
  221.  
  222. 0    23    *    *    *    getty -m0
  223. 0    11    *    *    *    getty -m1
  224.  
  225.     You can also kill (getty -0) or restart getty from your
  226.     crontab, though the prefered method is to leave it running
  227.     and only disable/enable the autoanswer (-r option) for those
  228.     times you wish your modem to not accept calls.
  229.  
  230. EXAMPLE HARDWIRED ENTRY
  231.     Lets say you have two amigas connected together via a permanent
  232.     serial line.  To run AmigaUUCP between them you want to run Getty
  233.     on one of them (NOT BOTH!).  On machine A you would run Getty
  234.     as follows:
  235.  
  236.     (Machine A):
  237.  
  238.         run >nil: <nil: Getty -B9600 -Md -h0 -c0
  239.  
  240.     The Passwd entry for the remote machine would be something like:
  241.     (Machine A)
  242.  
  243.         machb,uupc,203,0,(UUCP-NOPAS),ram:,uucico -h0 -o
  244.  
  245.     Machine B would have an L.sys entry that looks like:
  246.  
  247.         macha Any SER: 9600 "" "" \r\r\c ogin: machb sword: uupc
  248.  
  249.     In the above configuration, with Getty running on Machine A, Machine
  250.     B would run uucico (usually every X minutes from dcron) using:
  251.  
  252.         1> uucico -smacha -h0 -o -xx
  253.  
  254.     UNFORTUNATELY, with a permanent serial line you cannot run Getty
  255.     on BOTH machines.  This will cause one Getty to echo the other's
  256.     login message and vise versa, causing an infinite loop.  So only
  257.     one machine can poll.
  258.  
  259. FILES/REQUIRES
  260.     GETTY:PASSWD
  261.     GETTY:Getty-Header
  262.     GETTY:LOGFILE
  263.  
  264.     The NULL: handler must be mounted
  265.  
  266. REFERENCES
  267.     Getty
  268.     Passwd
  269.  
  270.